home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / comms / internet / html-related / aha! / install.aha!
Text File  |  1996-09-22  |  9KB  |  132 lines
  1. Install.AHa!
  2. ----------------------------------------------------------------------------------------------------
  3. AHa! is an Amiga HTML Assistant by Oleg Moskalensky
  4. Copyright © 1996 Productive Computer Systems - ALL RIGHTS RESERVED
  5.  
  6. Released as Public Domain for FREE use on September 21, 1996.  Not for commercial resale!!!
  7. ----------------------------------------------------------------------------------------------------
  8. Even though AHa! IS an acronym, the name initially came from my reaction when I realized how easy it
  9. would be to set up a very functional HTML editor, considering Amiga's superior capabilities in terms
  10. of multitasking and interprocess communication (Thank you, Bill Hawes!!!)
  11.  
  12. This HTML edit assistant is not the first ever produced for the Amiga, but most likely it is the
  13. smallest in size - the current version is a 6.5k Arexx program.  It's a perfect example of what can
  14. be done on Amiga.
  15. ----------------------------------------------------------------------------------------------------
  16.  
  17. P R E R E Q U I S I T E S
  18.  
  19. Keep in mind that this software was written for a specific environment.  It assumes that you're using
  20. Turbotext (text editor), IBrowse (Web browser) and Tool Manager (program launcher utility).  Also,
  21. Arexx must be running.  If you have these components at your disposal - the rest is easy.
  22. NOTE: Although this program significantly aids in reducing the time it takes to create HTML 
  23. documents, it does NOT teach you HTML itself.
  24. ----------------------------------------------------------------------------------------------------
  25.  
  26. I N S T A L L A T I O N 
  27.  
  28. Copy the contents of the Tools directory into SYS:Tools and contents of Arexx directory into REXX:.
  29. Once that's done then you'll need to save your current ToolManager configuration under the name
  30. ToolManagerStandard.prefs into SYS:Tools.  And that's that!
  31. NOTE: Even though Set.HTML.TMprefs and Set.Standard.TMprefs are located in SYS:Tools directory, I'd
  32. recommend 'leaving out' their icons, so they'll be instantly accessible right from Workbench.  That
  33. way you'll be able to quickly and easily switch between Tool Manager setup you normally have and the
  34. setup for HTML editing.
  35. ----------------------------------------------------------------------------------------------------
  36.  
  37. P H I L O S O P H Y   A N D   O P E R A T I O N
  38.  
  39. The idea behind this project was a simple one.  HTML is not a difficult language to learn and use,
  40. however it does require a lot of typing of fairly cryptic text.  I looked at various HTML editors and
  41. even though some of them are pretty good, none of them did EXACTLY what I wanted.  For example, I
  42. didn't like the editor in some implementations, some other ones worked too slow etc.  And most of
  43. them were in 100k plus range in terms of program size.
  44.  
  45. I use and love Turbotext for text editing, so since the folks at Oxxi already created an extremely
  46. potent editor - I figured, why reinvent the wheel.  The next item I needed for this environment was a
  47. simple set of buttons that would launch my Arexx program with certain parameters, depending on the
  48. button clicked.  Again, Tool Manager is an exceptionally useful utility and I could see how it could
  49. perfectly handle this task.  The third and final entity that I needed was an ability to SEE what I'm
  50. editing.  One choice was to write... a Web browser.  However, since Omnipresence folks did a far
  51. superior job than I ever could, with IBrowse, I stuck with my 'Don't reinvent the wheel' philosophy
  52. to use their browser to see what my HTML code actually looks like in a browser.
  53. All I needed was 'glue' to tie all of these totally independent apps together into one very
  54. functional, quick and convenient environment.  When it hit me how simple this would be - that's where
  55. AHa! name came from (and conveniently it actually spells Amiga HTML Assistant ;>)
  56.  
  57. So, the AHa!.rexx was written and since most of the work is done by other programs, it wound up being
  58. only 6.5k.  I'm sure it'll grow a little, since I have plans to add a few more functions, but if it
  59. reaches 10k - I'll be surprised.  The beauty, simplicity and power of Arexx!!!
  60.  
  61. To start the environment, simply double-click on Set.HTML.TMprefs icon.  That will change Tool
  62. Manager's preferences to use my special setup, instead of your normal Tool Manager setup.  Don't
  63. worry, if you installed everything as described above, getting your old Tool Manager setup is as
  64. simple as double-clicking on Set.Standard.TMprefs icon.
  65.  
  66. When you start the HTML editing environment, it'll automatically open Turbotext window as well.
  67. HINT: I configured Turbotext to open its windows on a separate screen.  Tool Manager configuration
  68. also points to the same screen (if available).  The default Turbotext window opens right under the
  69. group of Tool Manager's buttons, giving the appearance of a set of tools at the top of the screen, 
  70. with an editing area right below it.  This setup works really well.  Even though I can open as many
  71. Turbotext windows as I want/need, AHa! only talks to the first one.
  72.  
  73. The tool bar buttons are clearly marked.  Some of them are items that are inserted into the document
  74. below with a single click, some ask for additional parameters.  Most commands work in the following
  75. manner: if a command is selected (by clicking on it), one of two conditions occur:
  76.  
  77.   1) If a block was selected (by dragging the mouse and highlighting an area) - then the command
  78.   selected would be placed so it would display for the entire block.  For example if you highlight
  79.   3 lines and then click on Bold then the HTML tags will make the entire selected block be displayed
  80.   in bold when viewed in a browser.  Keep in mind that the selected block could be as small as one
  81.   letter or as large as you want.
  82.   
  83.   2) If a block was NOT selected (a cursor is somewhere in the document) - then the command selected
  84.   will place its tags in the beginning and end of the line the cursor is currently on.
  85.   
  86.   3) If a command (such as line break BR) is selected, it'll be placed at the point of the cursor.
  87.  
  88. These rules are pretty simple to remember, easy to use and actually very flexible.
  89.  
  90. So, in the normal course of events, I double-click on Set.HTML.TMprefs, then I select IBrowse from
  91. the Tools Workbench menu to launch it, then I either load or edit an HTML document and when I'm ready
  92. to see what it'll look like, I simply click on ->IBrowse button (second button on the first line) to
  93. have IBrowse load that document and show it to me.
  94.  
  95. Even though IBrowse does have a fairly decent Arexx port (in terms of commands), it does lack some
  96. screen management functions, so I'm using Turbotext's to push its screen back.  If you only have 2
  97. screens (Workbench and IBrowse) then it works perfectly.  If you have three (Turbotext, Workbench and
  98. Ibrowse), then you may need to rearrange the screens so when Turbotext is pushed back, IBrowse will
  99. move to the front.  Of course, if it doesn't, you can always get to it by hitting Left_Amiga-M combo.
  100.  
  101. Regardless, once ->IBrowse button is pushed, your Turbotext document will be automatically saved and
  102. then passed to IBrowse to display.
  103. NOTE: It's important that you initially save a new document under some name, so that IBrowse knows
  104. how to find it.  That only pertains to brand new documents, since existing documents already have a
  105. name.
  106.  
  107. After that it's a process of jumping back to Turbotext screen, making some changes and then clicking
  108. on ->IBrowse to see the results.
  109.  
  110. Since I didn't change the apps themselves, you can still utilize any and all functions of the
  111. running applications (i.e. use any of the editing features of Turbotext, possibly add to the Tool
  112. Manager setup or have one uniform setup for HTML editing and otherwise etc.).
  113.  
  114. That's all there's to it.  I redid my entire Web site and used this new tool and it saved a lot of
  115. time.  
  116. -----------------------------------------------------------------------------------------------------
  117.  
  118. P R O B L E M S   A N D   F U T U R E
  119.  
  120. Should you encounter any problems with AHa! environment, please e-mail me at pcs@accessone.com. I'm
  121. confident the problems can be resolved, since I know the environment works and works well on my
  122. Amigas.
  123.  
  124. In terms of the future... I'll expand it somewhat as I have time.  Any of your ideas suggestions are
  125. always welcome.  I can't promise anything, but I will certainly consider every idea and the latest
  126. version can always be found at http://www.accessone.com/~olegm.
  127.  
  128. E N J O Y ! ! !
  129.  
  130.  
  131.            Oleg Moskalensky,
  132.            Owner, PRODUCTIVE COMPUTER SYSTEMS